IRIX Base Documentation 2001 May/SGI IRIX Base Documentation 2001 May.iso/usr/share/catman/p_man/catD/cmn_err.z/cmn_err

Text File | 2001-04-17 | 20.8 KB | 265 lines

ccccmmmmnnnn____eeeerrrrrrrr((((DDDD3333))))                                                        ccccmmmmnnnn____eeeerrrrrrrr((((DDDD3333))))



NNNNAAAAMMMMEEEE
     _cccc_mmmm_nnnn______eeee_rrrr_rrrr - display an error message or panic the system

SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
     _####_iiii_nnnn_cccc_llll_uuuu_dddd_eeee _<<<<_ssss_yyyy_ssss_////_cccc_mmmm_nnnn______eeee_rrrr_rrrr_...._hhhh_>>>>
     _####_iiii_nnnn_cccc_llll_uuuu_dddd_eeee _<<<<_ssss_yyyy_ssss_////_dddd_dddd_iiii_...._hhhh_>>>>

     _vvvv_oooo_iiii_dddd _cccc_mmmm_nnnn______eeee_rrrr_rrrr_((((_iiii_nnnn_tttt _l_e_v_e_l_,,,, _cccc_hhhh_aaaa_rrrr _****_f_o_r_m_a_t_,,,, _...._...._.... _////_**** _aaaa_rrrr_gggg_ssss _****_////_))))_;;;;
     _vvvv_oooo_iiii_dddd _cccc_mmmm_nnnn______eeee_rrrr_rrrr______tttt_aaaa_gggg_((((_iiii_nnnn_tttt _s_e_q_n_u_m_b_e_r_,,,,_iiii_nnnn_tttt _l_e_v_e_l_,,,, _cccc_hhhh_aaaa_rrrr _****_f_o_r_m_a_t_,,,, _...._...._.... _////_**** _aaaa_rrrr_gggg_ssss _****_////_))))_;;;;

     _####_iiii_nnnn_cccc_llll_uuuu_dddd_eeee  _<<<<_ssss_tttt_dddd_aaaa_rrrr_gggg_...._hhhh_>>>>
     _vvvv_oooo_iiii_dddd _iiii_cccc_mmmm_nnnn______eeee_rrrr_rrrr_((((_iiii_nnnn_tttt _l_e_v_e_l_,,,, _cccc_hhhh_aaaa_rrrr _****_f_o_r_m_a_t_,,,, _vvvv_aaaa______llll_iiii_ssss_tttt _a_p_))))_;;;;


   AAAArrrrgggguuuummmmeeeennnnttttssss
     _s_e_q_n_u_m_b_e_r
          Unique sequence number for tracking particular message through
          _E_m_b_e_d_d_e_d _S_u_p_p_o_r_t _P_a_r_t_n_e_r (_E_S_P) subsystem.

     _l_e_v_e_l
          Indicates the severity of the error condition.

     _f_o_r_m_a_t
          The message to be displayed.

     _a_r_g_s The set of arguments passed with the message being displayed.

     _a_p   An argument list of type va_list, as documented in _ssss_tttt_dddd_aaaa_rrrr_gggg(5).

DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
     These functions display a message on the console and/or store it in the
     kernel buffer _pppp_uuuu_tttt_bbbb_uuuu_ffff.  They can also initiate a system panic. In addition
     to above functionality _cccc_mmmm_nnnn______eeee_rrrr_rrrr______tttt_aaaa_gggg allows to detect and identify message
     using unique _E_S_P sequence number. It can also activate different user
     defined actions through _E_S_P.

   RRRReeeettttuuuurrrrnnnn VVVVaaaalllluuuueeeessss
     None

UUUUSSSSAAAAGGGGEEEE
   sssseeeeqqqqnnnnuuuummmmbbbbeeeerrrr AAAArrrrgggguuuummmmeeeennnntttt
     The unique sequence number is used for tracking the particular message in
     the Embedded Support Partner environment. For more details see _eeee_ssss_pppp(1).

   lllleeeevvvveeeellll AAAArrrrgggguuuummmmeeeennnntttt
     Valid values for _l_e_v_e_l are:

          _CCCC_EEEE______CCCC_OOOO_NNNN_TTTT
                 Used to continue a previous message or to display an
                 informative message not connected with an error.





                                                                        PPPPaaaaggggeeee 1111






ccccmmmmnnnn____eeeerrrrrrrr((((DDDD3333))))                                                        ccccmmmmnnnn____eeeerrrrrrrr((((DDDD3333))))



          _CCCC_EEEE______DDDD_EEEE_BBBB_UUUU_GGGG
                 Used to display an informative message which is generally
                 expected to be of use only when debugging the associated
                 code.

          _CCCC_EEEE______NNNN_OOOO_TTTT_EEEE
                 Used to display a message preceded with ``_NNNN_OOOO_TTTT_IIII_CCCC_EEEE_:::: .''  This
                 message is used to report system events that do not
                 necessarily require action, but may interest the system
                 administrator.  For example, a message saying that a sector
                 on a disk needs to be accessed repeatedly before it can be
                 accessed correctly might be noteworthy.

          _CCCC_EEEE______WWWW_AAAA_RRRR_NNNN
                 Used to display a message preceded with ``_WWWW_AAAA_RRRR_NNNN_IIII_NNNN_GGGG_:::: .''  This
                 message is used to report system events that require
                 attention, such as those where if an action is not taken, the
                 system may panic or provide reduced functionality.
                 Generally, WARNINGs are associated with situations that are
                 less severe than ALERTs.  For example, when a peripheral
                 device does not initialize correctly, this level might be
                 used.

          _CCCC_EEEE______AAAA_LLLL_EEEE_RRRR_TTTT
                 Used to display a message preceded with ``_AAAA_LLLL_EEEE_RRRR_TTTT_:::: .''  This
                 message is used to report system events that require
                 immediate attention, such as those where if an action is not
                 taken, the system may panic or provide reduced functionality.
                 Generally, ALERTs are associated with situations that are
                 more severe than WARNINGs.  For example, when a networking
                 device loses its carrier, this level might be used.

          _CCCC_EEEE______PPPP_AAAA_NNNN_IIII_CCCC
                 Used to display a message preceded with ``_PPPP_AAAA_NNNN_IIII_CCCC_:::: ,'' and
                 panic the system.  Drivers should use this level only for
                 debugging or in the case of severe errors that indicate that
                 the system cannot continue to function.  This level halts
                 processing.

   ffffoooorrrrmmmmaaaatttt AAAArrrrgggguuuummmmeeeennnntttt
     The _f_o_r_m_a_t is a character string giving a message pattern in a style
     similar to that of f4printf(3S).

     By default, the message is sent both to the system console and to the
     circular kernel buffer _pppp_uuuu_tttt_bbbb_uuuu_ffff.  When the first character in _f_o_r_m_a_t is a
     circumflex (``_^^^^''), the message goes only to the console.  When the first
     character in _f_o_r_m_a_t is an exclamation point (``_!!!!''), the message goes
     only to _pppp_uuuu_tttt_bbbb_uuuu_ffff.

     The size of the kernel buffer _pppp_uuuu_tttt_bbbb_uuuu_ffff is defined by the kernel variable
     _pppp_uuuu_tttt_bbbb_uuuu_ffff_ssss_zzzz.  Driver developers or administrators can display the _pppp_uuuu_tttt_bbbb_uuuu_ffff
     buffer using appropriate debugging or administrative tools such as



                                                                        PPPPaaaaggggeeee 2222






ccccmmmmnnnn____eeeerrrrrrrr((((DDDD3333))))                                                        ccccmmmmnnnn____eeeerrrrrrrr((((DDDD3333))))



     _iiii_dddd_bbbb_gggg(1M).

          _cccc_mmmm_nnnn______eeee_rrrr_rrrr appends _\\\\_nnnn to each _f_o_r_m_a_t string, even when a message is
          sent to _pppp_uuuu_tttt_bbbb_uuuu_ffff, except when _l_e_v_e_l is _CCCC_EEEE______CCCC_OOOO_NNNN_TTTT.

          Valid conversion specifications are %_ssss, %_uuuu, %_dddd, %_oooo, and %_xxxx.  The
          _cccc_mmmm_nnnn______eeee_rrrr_rrrr function is otherwise similar to the _pppp_rrrr_iiii_nnnn_tttt_ffff(3S) library
          subroutine in its interpretation of the _f_o_r_m_a_t string, except that
          _cccc_mmmm_nnnn______eeee_rrrr_rrrr does not accept length specifications in conversion
          specifications.  For example, %_3333_dddd is invalid and will be treated as
          a literal string, resulting in a mismatch of arguments.

   aaaarrrrggggssss AAAArrrrgggguuuummmmeeeennnntttt
     Any argument within the range of supported conversion specifications can
     be passed.

   aaaapppp AAAArrrrgggguuuummmmeeeennnntttt
     The _iiii_cccc_mmmm_nnnn______eeee_rrrr_rrrr function is functionally the same as _cccc_mmmm_nnnn______eeee_rrrr_rrrr except that it
     takes a variable argument list as prepared by the _ssss_tttt_dddd_aaaa_rrrr_gggg(5) macros.  This
     allows the driver developer to create debugging functions that take
     arguments similar to those of _cccc_mmmm_nnnn______eeee_rrrr_rrrr, but that add extra features or
     perform conditional actions.

   GGGGeeeennnneeeerrrraaaallll CCCCoooonnnnssssiiiiddddeeeerrrraaaattttiiiioooonnnnssss
     At times, a driver may encounter error conditions requiring the attention
     of a system console monitor.  These conditions may mean halting the
     system; however, this must be done with caution.  Except during the
     debugging stage, or in the case of a serious, unrecoverable error, a
     driver should never stop the system.

     The _cccc_mmmm_nnnn______eeee_rrrr_rrrr function with the _CCCC_EEEE______CCCC_OOOO_NNNN_TTTT argument can be used by driver
     developers as a driver code debugging tool.  However, using _cccc_mmmm_nnnn______eeee_rrrr_rrrr in
     this capacity can change system timing characteristics.

   LLLLeeeevvvveeeellll
     Initialization, Base or Interrupt.

   SSSSyyyynnnncccchhhhrrrroooonnnniiiizzzzaaaattttiiiioooonnnn CCCCoooonnnnssssttttrrrraaaaiiiinnnnttttssss
     Does not sleep.

     If _l_e_v_e_l is _CCCC_EEEE______PPPP_AAAA_NNNN_IIII_CCCC, then driver-defined basic locks, read/write locks,
     and sleep locks may not be held across calls to this function.  For other
     levels, locks may be held.

   EEEExxxxaaaammmmpppplllleeeessss
     The _cccc_mmmm_nnnn______eeee_rrrr_rrrr function can record tracing and debugging information only in
     the _pppp_uuuu_tttt_bbbb_uuuu_ffff buffer (lines 12 and 13) or display problems with a device
     only on the system console (lines 17 and 18).  The _cccc_mmmm_nnnn______eeee_rrrr_rrrr______tttt_aaaa_gggg function
     allows to trace particular error event (lines 24 and 25) through _E_m_b_e_d_d_e_d






                                                                        PPPPaaaaggggeeee 3333






ccccmmmmnnnn____eeeerrrrrrrr((((DDDD3333))))                                                        ccccmmmmnnnn____eeeerrrrrrrr((((DDDD3333))))



     _S_u_p_p_o_r_t _P_a_r_t_n_e_r subsystem.

      _1111  _ssss_tttt_rrrr_uuuu_cccc_tttt  _dddd_eeee_vvvv_iiii_cccc_eeee _{{{{                   _////_**** _dddd_eeee_vvvv_iiii_cccc_eeee _rrrr_eeee_gggg_iiii_ssss_tttt_eeee_rrrr_ssss _llll_aaaa_yyyy_oooo_uuuu_tttt _****_////
          _...._...._....
      _2222   _iiii_nnnn_tttt _ssss_tttt_aaaa_tttt_uuuu_ssss_;;;;                    _////_**** _dddd_eeee_vvvv_iiii_cccc_eeee _ssss_tttt_aaaa_tttt_uuuu_ssss _wwww_oooo_rrrr_dddd _****_////
      _3333  _}}}}_;;;;

      _4444  _eeee_xxxx_tttt_eeee_rrrr_nnnn _ssss_tttt_rrrr_uuuu_cccc_tttt _dddd_eeee_vvvv_iiii_cccc_eeee _xxxx_xxxx______dddd_eeee_vvvv_[[[[_]]]]_;;;;     _////_**** _pppp_hhhh_yyyy_ssss_iiii_cccc_aaaa_llll _dddd_eeee_vvvv_iiii_cccc_eeee _rrrr_eeee_gggg_iiii_ssss_tttt_eeee_rrrr_ssss _****_////
      _5555  _eeee_xxxx_tttt_eeee_rrrr_nnnn _iiii_nnnn_tttt _xxxx_xxxx______cccc_nnnn_tttt_;;;;                 _////_**** _nnnn_uuuu_mmmm_bbbb_eeee_rrrr _oooo_ffff _pppp_hhhh_yyyy_ssss_iiii_cccc_aaaa_llll _dddd_eeee_vvvv_iiii_cccc_eeee_ssss _****_////
         _...._...._....
      _6666  _iiii_nnnn_tttt
      _7777  _xxxx_xxxx_oooo_pppp_eeee_nnnn_((((_dddd_eeee_vvvv______tttt _****_dddd_eeee_vvvv_pppp_,,,, _iiii_nnnn_tttt _ffff_llll_aaaa_gggg_,,,, _iiii_nnnn_tttt _oooo_tttt_yyyy_pppp_,,,, _cccc_rrrr_eeee_dddd______tttt _****_cccc_rrrr_pppp_))))
      _8888  _{{{{
      _9999   _ssss_tttt_rrrr_uuuu_cccc_tttt _dddd_eeee_vvvv_iiii_cccc_eeee _****_dddd_pppp_;;;;

     _1111_0000   _dddd_pppp _==== _xxxx_xxxx______dddd_eeee_vvvv_[[[[_gggg_eeee_tttt_mmmm_iiii_nnnn_oooo_rrrr_((((_****_dddd_eeee_vvvv_pppp_))))_]]]]_;;;;  _////_**** _gggg_eeee_tttt _dddd_eeee_vvvv _rrrr_eeee_gggg_iiii_ssss_tttt_eeee_rrrr_ssss _****_////
     _1111_1111  _####_iiii_ffff_dddd_eeee_ffff _DDDD_EEEE_BBBB_UUUU_GGGG                       _////_**** _iiii_nnnn _dddd_eeee_bbbb_uuuu_gggg_gggg_iiii_nnnn_gggg _mmmm_oooo_dddd_eeee_,,,, _llll_oooo_gggg _ffff_uuuu_nnnn_cccc_tttt_iiii_oooo_nnnn _cccc_aaaa_llll_llll _****_////
     _1111_2222   _cccc_mmmm_nnnn______eeee_rrrr_rrrr_((((_CCCC_EEEE______DDDD_EEEE_BBBB_UUUU_GGGG_,,,, _""""_!!!!_xxxx_xxxx_oooo_pppp_eeee_nnnn _ffff_uuuu_nnnn_cccc_tttt_iiii_oooo_nnnn _cccc_aaaa_llll_llll_,,,, _dddd_eeee_vvvv _==== _0000_xxxx_%%%%_xxxx_""""_,,,, _****_dddd_eeee_vvvv_pppp_))))_;;;;
     _1111_3333   _cccc_mmmm_nnnn______eeee_rrrr_rrrr_((((_CCCC_EEEE______CCCC_OOOO_NNNN_TTTT_,,,, _""""_!!!! _ffff_llll_aaaa_gggg _==== _0000_xxxx_%%%%_xxxx_""""_,,,, _ffff_llll_aaaa_gggg_))))_;;;;
     _1111_4444  _####_eeee_nnnn_dddd_iiii_ffff

     _1111_5555   _////_**** _dddd_iiii_ssss_pppp_llll_aaaa_yyyy _dddd_eeee_vvvv_iiii_cccc_eeee _pppp_oooo_wwww_eeee_rrrr _ffff_aaaa_iiii_llll_uuuu_rrrr_eeee _oooo_nnnn _ssss_yyyy_ssss_tttt_eeee_mmmm _cccc_oooo_nnnn_ssss_oooo_llll_eeee _****_////
     _1111_6666   _iiii_ffff _((((_((((_dddd_pppp_----_>>>>_ssss_tttt_aaaa_tttt_uuuu_ssss _&&&& _PPPP_OOOO_WWWW_EEEE_RRRR_)))) _====_==== _OOOO_FFFF_FFFF_))))
     _1111_7777        _cccc_mmmm_nnnn______eeee_rrrr_rrrr_((((_CCCC_EEEE______WWWW_AAAA_RRRR_NNNN_,,,, _""""_^^^^_xxxx_xxxx_oooo_pppp_eeee_nnnn_:::: _PPPP_oooo_wwww_eeee_rrrr _iiii_ssss _OOOO_FFFF_FFFF _oooo_nnnn _dddd_eeee_vvvv_iiii_cccc_eeee _%%%%_dddd _pppp_oooo_rrrr_tttt _%%%%_dddd_""""_,,,,
     _1111_8888           _gggg_eeee_tttt_eeee_mmmm_aaaa_jjjj_oooo_rrrr_((((_****_dddd_eeee_vvvv_pppp_))))_,,,, _gggg_eeee_tttt_eeee_mmmm_iiii_nnnn_oooo_rrrr_((((_****_dddd_eeee_vvvv_pppp_))))_))))_;;;;
     _1111_9999
     _2222_0000   _////_**** _ffff_iiii_xxxx _dddd_eeee_vvvv_iiii_cccc_eeee _llll_oooo_wwww _pppp_oooo_wwww_eeee_rrrr _llll_eeee_vvvv_eeee_llll _tttt_hhhh_rrrr_oooo_uuuu_gggg_hhhh _EEEE_SSSS_PPPP _ssss_uuuu_bbbb_ssss_yyyy_ssss_tttt_eeee_mmmm  _****_////
     _2222_1111   _////_**** _IIII_tttt _cccc_aaaa_nnnn _aaaa_cccc_tttt_iiii_vvvv_aaaa_tttt_eeee _ssss_oooo_mmmm_eeee _aaaa_cccc_tttt_iiii_oooo_nnnn_ssss _llll_iiii_kkkk_eeee _ssss_eeee_nnnn_dddd _eeee_mmmm_aaaa_iiii_llll_,,,, _ssss_hhhh_oooo_wwww _pppp_oooo_pppp_uuuu_pppp _****_////
     _2222_2222   _////_**** _wwww_iiii_nnnn_dddd_oooo_wwww _aaaa_nnnn_dddd _oooo_tttt_hhhh_eeee_rrrr_ssss _ffff_oooo_rrrr _tttt_hhhh_iiii_ssss _eeee_vvvv_eeee_nnnn_tttt _****_////
     _2222_3333   _iiii_ffff _((((_((((_dddd_pppp_----_>>>>_ssss_tttt_aaaa_tttt_uuuu_ssss _&&&& _PPPP_OOOO_WWWW_EEEE_RRRR_)))) _====_==== _LLLL_OOOO_WWWW_))))
     _2222_4444        _cccc_mmmm_nnnn______eeee_rrrr_rrrr______tttt_aaaa_gggg_((((_0000_xxxx_5555_8888_7777_3333_5555_,,,, _""""_xxxx_xxxx_oooo_pppp_eeee_nnnn_:::: _PPPP_oooo_wwww_eeee_rrrr _iiii_ssss _LLLL_OOOO_WWWW _oooo_nnnn _dddd_eeee_vvvv_iiii_cccc_eeee _%%%%_dddd _pppp_oooo_rrrr_tttt _%%%%_dddd_""""_,,,,
     _2222_5555           _gggg_eeee_tttt_eeee_mmmm_aaaa_jjjj_oooo_rrrr_((((_****_dddd_eeee_vvvv_pppp_))))_,,,, _gggg_eeee_tttt_eeee_mmmm_iiii_nnnn_oooo_rrrr_((((_****_dddd_eeee_vvvv_pppp_))))_))))_;;;;

RRRREEEEFFFFEEEERRRREEEENNNNCCCCEEEESSSS
     printf(3S), stdarg(5), print(D2), esp(1).




















                                                                        PPPPaaaaggggeeee 4444